---
title: Arquitectura de Carpetas
info: Una mirada detallada a la arquitectura de carpetas de nuestro servidor
image: /images/user-guide/fields/field.png
---

<Frame>
  <img src="/images/user-guide/fields/field.png" alt="Header" />
</Frame>

La estructura del directorio backend es la siguiente:

```
server
  └───ability
  └───constants 
  └───core
  └───database
  └───decorators
  └───filters
  └───guards
  └───health
  └───integrations
  └───metadata
  └───workspace
  └───utils
```

## Ability

Define permisos e incluye gestores para cada entidad.

## Decoradores

Define decoradores personalizados en NestJS para funcionalidad adicional.

Ver [decoradores personalizados](https://docs.nestjs.com/custom-decorators) para más detalles.

## Filtros

Incluye filtros de excepciones para manejar excepciones que puedan ocurrir en endpoints de GraphQL.

## Guardias

Ver [guardias](https://docs.nestjs.com/guards) para más detalles.

## Health

Incluye una API REST públicamente disponible (healthz) que devuelve un JSON para confirmar si la base de datos está funcionando como se esperaba.

## Metadatos

Define objetos personalizados y hace disponible una API de GraphQL (graphql/metadata).

## Espacio de trabajo

Genera y sirve un esquema GraphQL personalizado basado en los metadatos.

### Estructura del Directorio de Espacio de Trabajo

```
workspace

  └───workspace-schema-builder
    └───factories 
    └───graphql-types
    └───database
    └───interfaces
    └───object-definitions
    └───services
    └───storage
    └───utils
  └───workspace-resolver-builder
    └───factories
    └───interfaces
  └───workspace-query-builder
    └───factories
    └───interfaces
  └───workspace-query-runner
    └───interfaces
    └───utils 
  └───workspace-datasource
  └───workspace-manager
  └───workspace-migration-runner
  └───utils 
  └───workspace.module.ts   
  └───workspace.factory.spec.ts    
  └───workspace.factory.ts      
```

La raíz del directorio de espacio de trabajo incluye el `espacio.trabajo.factory.ts`, un archivo que contiene la función `createGraphQLSchema`. Esta función genera un esquema específico para el espacio de trabajo utilizando los metadatos para adaptar un esquema para espacios de trabajo individuales. By separating the schema and resolver construction, we use the `makeExecutableSchema` function, which combines these discrete elements.

Esta estrategia no solo se trata de organización, sino que también ayuda con la optimización, como el almacenamiento en caché de definiciones de tipos generados para mejorar el rendimiento y la escalabilidad.

### Constructor de Esquema de Espacio de Trabajo

Genera el esquema GraphQL, e incluye:

#### Fábricas:

Constructores especializados para generar constructos relacionados con GraphQL.

- La fábrica de tipos traduce los metadatos de los campos en tipos GraphQL utilizando `TypeMapperService`.
- La fábrica de definiciones de tipos crea objetos de entrada o salida de GraphQL derivados de `objectMetadata`.

#### Tipos GraphQL

Incluye enumeraciones, entradas, objetos y escalares, y sirve como bloques de construcción para la construcción del esquema.

#### Interfaces y Definiciones de Objetos

Contiene los planos para entidades GraphQL, e incluye tanto tipos predefinidos como personalizados como `MONEY` o `URL`.

#### Servicios

Contiene el servicio responsable de asociar FieldMetadataType con su escalar de GraphQL apropiado o modificadores de consulta.

#### Almacenamiento

Incluye la clase `TypeDefinitionsStorage` que contiene definiciones de tipos reutilizables, previniendo duplicación de tipos GraphQL.

### Constructor de Resolver de Espacio de Trabajo

Crea funciones de resolutor para consultar y modificar el esquema GraphQL.

Cada fábrica en este directorio es responsable de producir un tipo de resolutor distinto, como el `FindManyResolverFactory`, diseñado para aplicación adaptable a través de varias tablas.

### Ejecutor de Consultas de Espacio de Trabajo

Ejecuta las consultas generadas en la base de datos y analiza el resultado.
